Configurable Data Group

A "Configurable Data Group" (CfgDg or CfgMB) provides a flexible way to create custom data groups on a per-device basis by using the remote device editor. You can use such data groups in one-off scenarios like testing or, if the data group definition is more broadly useful, paste its XML into the applicable device template file. You may add and configure up to 999 of these data groups per remote device.

Best practice recommends first writing a thorough device template file to accommodate as many of your field devices as possible. Then use a remote device editor to add one or more "Configurable Data Group(s)" on an ad hoc basis to suit unique situations.

You might find the CygNet DDS Data Group Copy Utility useful for copying a unique "Configurable Data Group" to other remote devices. You might find the Device Copy utility useful for copying remote devices that use the "Configurable Data Group(s)."

See the following subsections for more information:

• Define a Configurable Data Group
  • Configurable Data Group Definition Properties
• Define a Configurable Data Group Element
  • Data Group Element Definition Properties

Define a Configurable Data Group

Perform the following steps to define a configurable data group.

To Define a Configurable Data Group

1. Using CygNet Explorer, right-click in your DDS pane, click Remote Devices, and open the remote device to which you want to add a "Configurable Data Group".
2. In the remote device Properties editor, click the Data Group page, click Add, and double-click Configurable Data Group.
3. Define general data group properties, then click Configure. (Ord# is only used as a data group identifier; it has no special uses beyond identifying an instance of a "Configurable Data Group".)
4. In the Configurable Data Group Definition dialog box that opens, specify "Configurable Data Group" settings. See Configurable Data Group Definition Properties.
5. Click Add to add a new element to your "Configurable Data Group". Add as many data group elements as your "Configurable Data Group" requires.
6. Highlight the new element and click Edit to define the new element. Your finished "Configurable Data Group" might look something like this:

IOT Configurable Data Group Definition

7. If you define the data group and want to add its XML to a device template file, click Edit XML and paste the data group XML into the applicable device template file.
8. If you've deleted elements in the process of creating the data group and want to reorder the existing elements in sequential order, click Renumber elements. (If you've given an element a custom name, clicking Renumber elements will overwrite the name.)
9. When you are finished, click OK and click OK again in the Data Group Properties dialog box.

Configurable Data Group Definition Properties

The following table lists and describes the properties of the Configurable Data Group Definition dialog box.

Item	Description
Security level	See secLev.
Can read	This option is not available for the IoT EIE or IoT Sparkplug EIE.
Can read via UIS command	This option is not available for the IoT EIE or IoT Sparkplug EIE.
Can write	This option is not available for the IoT EIE or IoT Sparkplug EIE.
Can write via UIS command	This option is not available for the IoT EIE or IoT Sparkplug EIE.
Data group elements
Item	The name of an element. This can be modified in the XML file. See DataGroupElement.
Description	See desc.
Item ID	The name of the item in the payload file.
Reference	See ref.
Data type	See type.
Add	Click Add to add a new element. If another element is currently highlighted, the added element is a copy of the highlighted element. See DataGroupElement.
Edit	Click to edit the selected element.
Delete	Click to delete a selected element.
Edit XML	Click to open your "Configurable Data Group Definition" in an XML editor. Make changes if required. This is useful for fine-tuning your configurable data group definition or for copying and pasting the data group definition into a device template file.
Renumber elements	Click to reset the numbering of your elements to a simple consecutive format. This is useful if you've deleted elements and want the data group elements to be more tightly ordered. Clicking Renumber elements overwrites data group element IDs whose names you have changed in the configurable data group's XML definition.
Clear definition	Click to clear the entire data group definition.

Define a Configurable Data Group Element

Perform the following steps to define a configurable data group element.

To Define a Configurable Data Group Element

1. At the Configurable Data Group Definition dialog box, click Add. Add as many data group elements as your "Configurable Data Group" requires.
2. Highlight the data group element you want to define and click Edit. A dialog box like the following appears:

IOT Data Group Element Definition

3. Specify the Data type and other "Configurable Data Group" data group element settings. See Data Group Element Definition Properties.
4. When you are finished, click OK. Repeat steps 1 - 3 until you've added all required data group elements.
5. When you are finished, click OK.
6. If you define the data group and want to add its XML to a device template file, click Edit XML and paste the data group XML into the applicable device template file.
7. If you've deleted elements in the process of creating the data group and want to reorder the existing elements in sequential order, click Renumber elements. (If you've given an element a custom name, clicking Renumber Elements will overwrite the name.)
8. When you are finished, click OK and click OK again in the Data Group Properties dialog box.

Data Group Element Definition Properties

The following table lists and describes the properties of the Data Group Element Definition dialog box.

Item	Description
Data group element	Displays the selected data group element.
Description	See desc.
Data type	See type.
Units	See units.
Display mask	See dMask.
Data source
By Item ID	Selecting this option enables editing of the Item ID field.
Item ID	See itemId.
By Element Reference	Selecting this option enables editing of the Element Reference field.
Element Reference	See ref.
Bit position	See bPos.
Bit mask	See bMask.
XOR mask	See bXorMask.